docs(claude): clarify OpenRouter model selection by shivamhwp · Pull Request #11369 · pingdotgg/t3code

shivamhwp · 2026-09-12T03:52:54Z

OpenRouter users can select a built-in Claude model while expecting ANTHROPIC_DEFAULT_*_MODEL to substitute another model. T3 passes an explicit model ID, so those alias overrides do not apply.

The guide now explains how to select a custom OpenRouter model, notes its limited model controls, and asks users to verify the billed model in OpenRouter.

Checked against the model-ID resolver, custom-model capability defaults and picker behavior. Documentation-only change; diff check passes.

Refs #4149. This addresses model selection guidance only. The reported worktree routing and default behavior remain open. Rebased onto main.

GPT-6 via Codex in T3 Code.

Rebased on main 20363c32c9bfdbf49c2716ef11d1f18483fcc01b. Scoped validation rerun after rebasing; existing native and human review limits remain.

Summary by CodeRabbit

Documentation
- Updated OpenRouter guidance for selecting models in T3 Code.
- Clarified how to enter full custom model IDs when needed.
- Explained Claude Code model aliases and capability controls.
- Updated verification steps to use OpenRouter’s activity dashboard.

macroscopeapp · 2026-09-12T03:55:13Z

Approvability

Verdict: Approved at a7e29ca

Macroscope's review found this PR approvable — This PR only clarifies existing OpenRouter model-selection instructions in user documentation and does not alter runtime behavior or product defaults. An unresolved Medium finding identifies possible ordering ambiguity in those instructions and should be addressed separately.

Notes:

This verdict was updated automatically after the outstanding correctness findings were resolved. Macroscope did not re-review the code.

No code changes detected at 0649c36. Prior analysis still applies.

^{You can add or adjust custom eligibility rules. Learn more.}

github-actions · 2026-09-12T03:55:54Z

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.6 KiB	13.6 KiB	+48 B (+0.3%)	15.1 KiB	✅
Codex	Thread snapshot wire	7.1 KiB	7.0 KiB	−3 B (−0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.5 KiB	6.6 KiB	+51 B (+0.8%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	57.0 KiB	57.1 KiB	+88 B (+0.2%)	66.4 KiB	✅
Codex	Live turn messages	8	10	+2 (+25.0%)	21	✅
Claude	Total thread wire	13.6 KiB	13.6 KiB	+9 B (+0.1%)	15.1 KiB	✅
Claude	Thread snapshot wire	7.1 KiB	7.1 KiB	−6 B (−0.1%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.5 KiB	6.5 KiB	+15 B (+0.2%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	57.8 KiB	57.8 KiB	+44 B (+0.1%)	66.4 KiB	✅
Claude	Live turn messages	8	9	+1 (+12.5%)	21	✅

Baseline: d8655ed · PR result: 0649c36 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

Codex decoded thread snapshot: 113.9 KiB
Claude decoded thread snapshot: 114.6 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

coderabbitai · 2026-09-13T15:45:33Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 66d1e4f5-8878-4e01-a7cf-5605a7391624

📥 Commits

Reviewing files that changed from the base of the PR and between 20363c3 and 2e0c251.

📒 Files selected for processing (1)

docs/user/providers-claude.md

Limit details: You’ve used all 10 included reviews currently available.

📝 Walkthrough

Walkthrough

The OpenRouter setup documentation now explains model selection in T3 Code, custom model IDs, Claude Code alias behavior, capability controls, and model verification through OpenRouter’s activity dashboard.

Changes

OpenRouter documentation

Layer / File(s)	Summary
Model selection guidance `docs/user/providers-claude.md`	The setup instructions cover built-in and custom model IDs, clarify that `ANTHROPIC_DEFAULT_*_MODEL` aliases do not override explicit T3 Code selections, note that custom models may expose fewer controls, and use OpenRouter’s activity dashboard for verification.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~5 minutes

Change: Other

Suggested reviewers: t3dotgg

Merge Risk: ⚪ Minimal · up to 0649c

This documentation-only update introduces no established product or production risk and is mergeable after normal documentation checks.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title clearly and concisely describes the documentation change: clarifying OpenRouter model selection for Claude.
Description check	✅ Passed	The description explains what changed, why it changed, the documentation-only scope, validation performed, and the related issue. It omits the template headings and checklist, but the required content…

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch docs/claude-router-explicit-model

_{Comment @coderabbitai help to get the list of available commands.}

cursor · 2026-09-13T16:00:31Z

Bugbot is paused — on-demand spend limit reached

Bugbot uses usage-based billing for this team and has hit its on-demand spend limit.

A team admin can raise the spend limit in the Cursor dashboard, or wait for the next billing cycle to continue.

cursor · 2026-09-14T06:55:55Z

Bugbot is paused — on-demand spend limit reached

Bugbot uses usage-based billing for this team and has hit its on-demand spend limit.

A team admin can raise the spend limit in the Cursor dashboard, or wait for the next billing cycle to continue.

@t3dotgg

## What's Changed * fix(web): disconnect offline servers from threads by @t3dotgg in pingdotgg/t3code#11671 * feat(web): flatten the connections page into one environments list by @t3dotgg in pingdotgg/t3code#11672 * fix(mobile): keep usage widget rows consistently sized by @juliusmarminge in pingdotgg/t3code#11669 * feat(server): add reusable auth token for dev worktrees by @t3dotgg in pingdotgg/t3code#8606 * feat(settings): choose how responses stream, with a warning on legacy token mode by @t3dotgg in pingdotgg/t3code#11678 * revert(web): remove the compact sidebar by @maria-rcks in pingdotgg/t3code#11685 * build(desktop): bundle the main process and stage only its native externals by @juliusmarminge in pingdotgg/t3code#11410 * build(server): make the CLI bundle loadable as a Node single-executable by @juliusmarminge in pingdotgg/t3code#11316 * ci(release): build, sign, and publish self-contained CLI archives by @juliusmarminge in pingdotgg/t3code#11317 * feat(server): install preview runtimes from release archives by @juliusmarminge in pingdotgg/t3code#11318 * feat(ssh): run preview builds on remotes from the release archive by @juliusmarminge in pingdotgg/t3code#11319 * feat(cli): add t3 update for self-contained installs by @juliusmarminge in pingdotgg/t3code#11451 * feat(server): manage runtimes as release archives only, never from npm by @juliusmarminge in pingdotgg/t3code#11510 * feat(desktop): run the WSL backend from the Linux CLI archive by @juliusmarminge in pingdotgg/t3code#11511 * ci(release): build CLI archives for five targets, each on its own architecture by @juliusmarminge in pingdotgg/t3code#11605 * ci(release): build the JS bundle once and run every platform and architecture in parallel by @juliusmarminge in pingdotgg/t3code#11606 * feat(release): publish npx t3 as a launcher over per-platform executable packages by @juliusmarminge in pingdotgg/t3code#11607 * feat(cli): add t3 uninstall for self-contained installs by @juliusmarminge in pingdotgg/t3code#11659 * feat(web): show each worktree setup step and let users cancel it by @t3dotgg in pingdotgg/t3code#11372 * fix(server): skip device hosts that resolve to the local machine by @juliusmarminge in pingdotgg/t3code#11698 * fix(web): test device hosts across selected environments by @juliusmarminge in pingdotgg/t3code#11699 * feat(desktop): allow disabling the local environment by @juliusmarminge in pingdotgg/t3code#9194 * feat(cli): add t3 service restart and make t3 update repoint the service eagerly by @juliusmarminge in pingdotgg/t3code#11702 * docs(claude): clarify OpenRouter model selection by @shivamhwp in pingdotgg/t3code#11369 **Full Changelog**: pingdotgg/t3code@v0.0.41-nightly.20260914.1687...v0.0.41-nightly.20260914.1700 Upstream release: https://github.com/pingdotgg/t3code/releases/tag/v0.0.41-nightly.20260914.1700

github-actions Bot added vouch:trusted PR author is trusted by repo permissions or the VOUCHED list. size:S 10-29 changed lines (additions + deletions). labels Sep 12, 2026

macroscopeapp Bot reviewed Sep 12, 2026

View reviewed changes

Comment thread docs/user/providers-claude.md

macroscopeapp Bot approved these changes Sep 12, 2026

View reviewed changes

shivamhwp changed the base branch from fix/client-device-ticket-http-group to main September 13, 2026 15:42

shivamhwp force-pushed the docs/claude-router-explicit-model branch from a7e29ca to 2e0c251 Compare September 13, 2026 15:42

github-actions Bot added 📱 Native Change Changes the native fingerprint; merging blocks production OTAs until a new store build ships. size:XXL 1,000+ changed lines (additions + deletions). and removed size:S 10-29 changed lines (additions + deletions). labels Sep 13, 2026

shivamhwp force-pushed the docs/claude-router-explicit-model branch from 2e0c251 to eba419b Compare September 13, 2026 16:00

github-actions Bot added size:S 10-29 changed lines (additions + deletions). and removed size:XXL 1,000+ changed lines (additions + deletions). labels Sep 13, 2026

shivamhwp added 2 commits September 14, 2026 06:55

docs(claude): clarify OpenRouter model selection

9c1de25

docs(claude): use current custom model settings path

0649c36

shivamhwp force-pushed the docs/claude-router-explicit-model branch from eba419b to 0649c36 Compare September 14, 2026 06:55

shivamhwp merged commit 01e05c1 into main Sep 14, 2026
23 checks passed

shivamhwp deleted the docs/claude-router-explicit-model branch September 14, 2026 07:10

faw01 pushed a commit to faw01/t3code that referenced this pull request Sep 14, 2026

docs(claude): clarify OpenRouter model selection (pingdotgg#11369)

356c48d

Navigation Menu

Uh oh!

docs(claude): clarify OpenRouter model selection - #11369

docs(claude): clarify OpenRouter model selection#11369
shivamhwp merged 2 commits into
mainfrom
docs/claude-router-explicit-model

shivamhwp commented Sep 12, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

Uh oh!

macroscopeapp Bot commented Sep 12, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Sep 12, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Sep 13, 2026 •

edited

Loading

Walkthrough

Changes

Uh oh!

cursor Bot commented Sep 13, 2026

Uh oh!

cursor Bot commented Sep 14, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

shivamhwp commented Sep 12, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by CodeRabbit

Uh oh!

Uh oh!

macroscopeapp Bot commented Sep 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Approvability

Uh oh!

github-actions Bot commented Sep 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Thread transfer impact

Uh oh!

coderabbitai Bot commented Sep 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Uh oh!

cursor Bot commented Sep 13, 2026

Bugbot is paused — on-demand spend limit reached

Uh oh!

cursor Bot commented Sep 14, 2026

Bugbot is paused — on-demand spend limit reached

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

shivamhwp commented Sep 12, 2026 •

edited by coderabbitai Bot

Loading

macroscopeapp Bot commented Sep 12, 2026 •

edited

Loading

github-actions Bot commented Sep 12, 2026 •

edited

Loading

coderabbitai Bot commented Sep 13, 2026 •

edited

Loading